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1 ABOUT THIS DOCUMENT 


This document is your introduction to application development 
using the text and graphics imaging resources of the DISPLAY 
PostScript® system. 

This introduction for the application programmer describes: 

• The Display PostScript system environment you’ll be 
interacting with. 

• The Client Library interface you’ll be programming for. 

• The use of the pswrap translator to prepare C-callable 
procedures containing POSTSCRIPT® language programs. 

• The manuals you’ll need. 


2 ABOUT THE DISPLAY POSTSCRIPT SYSTEM 

The Display PostScript system provides a device-independent 
imaging model for displaying information on a screen. This im¬ 
aging model is fully compatible with the imaging model used in 
PostScript printers. By allowing you to use the PostScript 
language to display text, graphics, and sampled images, it frees 
you from display-specific details such as screen resolution and 
number of available colors. 

You can look at the Display PostScript system as part of the 
window system. Your application will use window system fea¬ 
tures for window placement and sizing, menu creation, and event 
handling, while using DISPLAY POSTSCRIPT features to take care 
of imaging inside the window. 

Display PostScript system components include the Client 
Library, the POSTSCRIPT interpreter, and the pswrap translator. 
These components are described in the accompanying set of 
manuals. If you are a new PostScript language programmer, 
you’ll also need copies of the PostScript language manuals. 
See Section 6 for a discussion of documentation required by ap¬ 
plication developers. 

Figure 1 shows the relationship between your application and the 


2 ABOUT THE Display PostScript SYSTEM 


1 



Display PostScript system. The Client Library contains data 
structures and procedures your application will use to send re¬ 
quests to the PostScript interpreter. No matter what operating 
system you’re dealing with, you can send PostScript language 
programs to the interpreter in the same way, using the same pro¬ 
cedure calls. Therefore portability issues are minimized if you’re 
developing an application for more than one environment. 

Figure 1 The Display PostScript System 
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3 APPLICATION BUILDING BLOCKS 

Most of your application will be written in C or another high- 
level languge. You’ll call Client Library procedures to start a 
POSTSCRIPT execution context, send programs and data to the 
PostScript interpreter, and get results from the the interpreter. 
The Client Library is the application’s primary interface to the 
Display PostScript system. 

In addition, you’ll call wraps — POSTSCRIPT language 
procedures developed specifically for your application. Wraps, 
short for wrapped procedures, are created by the pswrap trans¬ 
lator from POSTSCRIPT language programs written to meet appli¬ 
cation needs. Figure 2 on page 4 shows how an application 
program is built. 
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4 USING PSWRAP 


Your application will perform calculations, communicate with 
the window system, read and write files, and do other application 
processing in C or another high-level language. It will perform 
imaging tasks by calling wrapped procedures to send 
POSTSCRIPT language programs to the interpreter. The pswrap 
translator creates these wraps from PostScript language input. 

Figure 2 shows how an application is built of C source code and 
POSTSCRIPT language code translated into C-callable procedures 
by pswrap. 
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Figure 2 Creating a Display PostScript Application 



Consider a wrap, PWDisplayText, that places text on the screen 
at a particular x,y coordinate. A call to PWDisplayText from the 
application program might look something like this: 

PWDisplayText(72.0,100.0, "Hello World"); 

The body of the PWDisplayText procedure, is actually written in 
the PostScript language. It was defined to pswrap as follows: 
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defineps PWDisplayText(float X,Y; char *text) 

X Y moveto 
(text) show 
endps 

In the wrap definition, the ‘defineps’ and ‘endps’ keywords tell 
pswrap where a given POSTSCRIPT language program begins and 
ends. The ‘defineps’ statement defines the resulting procedure 
call. The pswrap translator processes this input and produces a C 
language source-code file. When compiled and linked with the 
application, the PWDisplayText procedure sends a POSTSCRIPT 
language program to the interpreter (binary-encoded for more ef¬ 
ficient processing), causing the specified text to be displayed. 

To summarize, pswrap takes a PostScript language program as 
input and gives you back a C language program. After you com¬ 
pile the resulting C program and link it into your application, 
calling the wrap will transmit a stream of PostScript language 
binary objects to the interpreter. 


5 THE CLIENT LIBRARY INTERFACE 

The Client Library is a linkable library of compiled C procedures 
that provides an interface between the application and the 
DISPLAY PostScript system. It creates an environment for han¬ 
dling imaging calls to specific Client Library procedures like 
DPSmoveto and custom wraps written for the application. 

The Client Library is tailored by the DISPLAY POSTSCRIPT sys¬ 
tem vendor for your particular operating environment. The 
Client Library Reference Manual describes a generic interface; 
your system vendor may add additional features or slightly 
modify the interface to suit your hardware and software. See 
your vendor’s system-specific documentation for details. 


6 MANUALS FOR APPLICATION DEVELOPERS 

The accompanying set of manuals contains information needed 
by a POSTSCRIPT programmer developing an application for the 
Display PostScript system. If you’re new to the PostScript 
language, you should first read the following manuals (published 
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for Adobe by Addison-Wesley and available by calling 

1-800-344-8335 or through your technical bookstore): 

POSTSCRIPT Language Reference Manual 

The standard reference for the POSTSCRIPT lan¬ 
guage. Describes the PostScript imaging 
model and the concepts and facilities of the 
POSTSCRIPT interpreter. Documents the 
PostScript language. Required reading. 

POSTSCRIPT Language Tutorial and Cookbook 

Provides an informal, interactive introduction to 
the POSTSCRIPT language and a collection of 
programs that offer examples of POSTSCRIPT 
usage. 

PostScript Language Program Design 

Gives guidelines for designing and debugging 
POSTSCRIPT language programs. Printer- 
oriented, but some of the information is relevant 
to writing for a DISPLAY POSTSCRIPT applica¬ 
tion. 

Once you’re up to speed in the POSTSCRIPT language, read the 

following manuals: 

PostScript Language Extensions for the DISPLAY POSTSCRIPT 
System 

Describes the extensions to the POSTSCRIPT lan¬ 
guage that were made for the DISPLAY 
PostScript system, such as alternative 
POSTSCRIPT language encodings, multiple ex¬ 
ecution contexts, user paths, window system 
support, and memory management. Introduces 
important system concepts and documents addi¬ 
tional PostScript operators. 

Client Library Reference Manual 

Describes the procedural interface to the 
Display PostScript system. Tells how to send 
programs and data to a PostScript execution 
context, how to handle context output, how to 
create and terminate a context. Contains proce¬ 
dure definitions, programming tips, and a 
sample application program. 
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pswrap Reference Manual 

Describes how to define C-callable procedures 
that contain POSTSCRIPT language programs. 
Tells how to declare input arguments and output 
to be received from the interpreter. Documents 
the pswrap command line options. 

PostScript Language Color Extensions 

Describes color extensions to the POSTSCRIPT 
language, including multiple color images, color 
halftone screen definitions, color correction, and 
CMYK color specification. 

Because of the nature of Display PostScript, some of the in¬ 
formation you need to write programs is necessarily system- 
specific. Therefore, in addition to the manuals listed above, 
you’ll need to consult the documentation provided by your sys¬ 
tem software vendor. The following system-specific documen¬ 
tation is available from Adobe: 

X Window System Programmer’s Supplement to the Client 
Library Reference Manual 
Describes information about the Client Library 
interface that is specific to the X Window 
System™, such as context creation and addition¬ 
al error codes. 
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How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 
before placing your electronic, telephone, or direct mail order. 

Electronic Orders 

To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using 
a 1200- or 2400-baud modem. If you need assistance using the Electronic Store, 
call 800-DIGITAL (800-344-4825). 

Telephone and Direct Mail Orders 

Your Location Call Contact 

Continental USA, 800-DIGITAL Digital Equipment Corporation 

Alaska, or Hawaii P.O. Box CS2008 

Nashua, New Hampshire 03061 

Puerto Rico 809-754-7575 Local DIGITAL subsidiary 

Canada 800-267-6215 Digital Equipment of Canada 

Attn: DECdirect Operations KA02/2 
P.O. Box 13000 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 

Local DIGITAL subsidiary or 
approved distributor 

SDC Order Processing - WMO/E15 
or 

Software Distribution Center 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


'For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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